home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / admin / fsmount.man < prev    next >
Encoding:
Text File  |  1992-12-17  |  4.1 KB  |  112 lines
  1. '\" Copyright 1989 Regents of the University of California
  2. '\" Permission to use, copy, modify, and distribute this
  3. '\" documentation for any purpose and without fee is hereby
  4. '\" granted, provided that this notice appears in all copies.
  5. '\" The University of California makes no representations about
  6. '\" the suitability of this material for any purpose.  It is
  7. '\" provided "as is" without express or implied warranty.
  8. '\" 
  9. '\" $Header: /sprite/src/admin/fsmount/RCS/fsmount.man,v 1.2 92/02/06 12:04:45 voelker Exp Locker: jhh $ SPRITE (Berkeley)
  10. '/" 
  11. .so \*(]ltmac.sprite
  12. .HS FSMOUNT cmds
  13. .BS
  14. '\" Note:  do not modify the .SH NAME line immediately below!
  15. .SH NAME
  16. fsmount \- Check disks and export prefixes 
  17. .SH SYNOPSIS
  18. \fBfsmount\fR [\fIoptions\fR]
  19. .SH OPTIONS
  20. .IP "\fB\-W\fR" 15
  21. Check disks, but do not write changes.
  22. .IP "\fB\-f\fR" 15
  23. Don't check disks (fastboot).
  24. .IP "\fB\-v\fR" 15
  25. Have both \fBfsmount\fR and \fBfscheck\fR  output verbose information
  26. while running (the default).
  27. .IP "\fB\-n\fR" 15
  28. Don't attach disks or export prefixes.
  29. .IP "\fB\-p\fR" 15
  30. Print out actions but don't execute them.
  31. .IP "\fB\-help\fR" 15
  32. Print a summary of the command-line options and exit.
  33. .IP "\fB\-d \fIdeviceDirectory\fR" 15
  34. Specifies the directory containing the device files.
  35. The default is "/dev/".
  36. .IP "\fB\-i \fIspriteID\fR" 15
  37. Causes prefixes that this machine will export to be preloaded into the
  38. prefix table with \fIspriteID\fR as the server. 
  39. This prevents the machine from broadcasting for its own prefixes while
  40. the disks are being checked.
  41. .IP "\fB\-fscheck \fIfscheckProg\fR" 15
  42. Use this to specify an alternative fscheck program, i.e., when testing
  43. a new fscheck.
  44. .IP "\fB\-C\fR" 15
  45. Don't conditionally check the disks.  
  46. The default behavior is to not check the disks 
  47. if they were just checked by \fIfscheck\fR
  48. and we are now rebooting.
  49. If the \fB\-C\fR
  50. flag is present then the disks will be checked regardless.
  51. .BE
  52.  
  53. .SH DESCRIPTION
  54. .PP
  55. \fBFsmount\fR is used during system boot to check the disks for 
  56. inconsistencies and
  57. to export prefixes.
  58. It is a replacement for \fBfsattach\fR, and is intented to be used without
  59. a mount table.  It uses \fBfsinfo\fR to determine what filesystems are
  60. on the disks connected to the host, \fBfscheck\fR to check the filesystems
  61. found (if they are OFS), and \fBprefix\fR to mount and export them.
  62. In this way, disks can change hosts, change prefixes, or change
  63. parititioning without having to update a mount table file.
  64. .PP
  65. \fBFsmount\fR does some checking before it \fBprefix\fRes filesystems.  If
  66. it finds filesystems whose cylinder extents overlap, it will only
  67. \fBprefix\fR the larger of the filesystems.  If more than one
  68. filesystem has the same prefix, it will try to mount those filesystems
  69. until one successfully mounts and it will ignore the remainder.  If a
  70. filesystem has a prefix of a filesystem already in the prefix table,
  71. it is ignored.
  72. .PP
  73. Currently, \fBfsmount\fR detects and notes root partitions, but does
  74. not try to either check or mount them.
  75. .PP
  76. Upon completion, \fBfsmount\fR creates a \fBfsmounted\fR file in
  77. \fB/hosts/$HOST/fsmounted\fR reporting the filesystems it mounted
  78. and exported, and when it did so.
  79.  
  80. .SH RETURN CODES
  81. \fBFsmount\fR returns the same error codes as \fBfsattach\fR:
  82. .IP 0
  83. No error.
  84. .IP 1
  85. An error was found in the root partition. Reboot the system. See \fBfscheck\fR
  86. for details.
  87. .IP 2
  88. A hard error occurred. There was some problem in either \fBfsattach\fR, 
  89. \fBfscheck\fR,
  90. or \fBprefix\fR that prevented \fBfsattach\fR from completing normally.
  91. .IP 3 
  92. \fBFscheck\fR returned a soft error indication. See \fBfscheck\fR for details.
  93. .IP 4
  94. An error was found in the root partition, but the number of consecutive
  95. times that \fBfscheck\fR was run and an error found exceeds the limit.
  96. .KS
  97. .SH FILES
  98. .DS L
  99. .nf
  100. /boot/cmds/fsinfo            command to list filesystems on disk
  101. /boot/cmds/fscheck            command to check disks
  102. /hosts/$HOST/*.fsc            output from fscheck
  103. /bootTmp/.fscheck.out        temporary output from fscheck
  104. /boot/cmds/prefix            command to mount and export filesystems
  105. /hosts/$HOST/fsmounted        report file for fsmount
  106. .DE
  107. .KE
  108. .fi
  109. .SH KEYWORDS
  110. fsmount, fscheck, prefix, fsinfo, fsdomain, mount, disk, partition, crash, attach, boot 
  111.  
  112.